<?php

namespace tjsd\mappers;

/**
 * Indexes are used to map path to a value and than find that value, if we know
 * the path.
 * 
 * Generaly, path is an array containg steps needed to find the value. Indexes are
 * most often used to store key:value pairs where key is an array and value is a string.
 * 
 * @author Jakub Tesárek <info@tjsd.cz>
 * @copyright 2012
 * @version 1.0
 */
interface Index {
	
	/**
	 * Finds value stored in in given path.
	 * 
	 * @param array $path	array with identifiers
	 * @return string			value in path or null if nothing found
	 */
	public function find(array $path);
}